home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / zcommdoc.zip / ZCOMMDOC.AD < prev    next >
Text File  |  1993-05-30  |  73KB  |  1,771 lines
  1.  
  2.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                   91
  4.  
  5.             indicating emulation of a Tektronix 4010 series storage tube
  6.             terminal, status line updates are inhibited when Tek graphics is
  7.             active.
  8.  
  9.             If the TERM environment parameter begins with "wy" (as in
  10.             "wy60") ZCOMM will use and recognize Wyse escape sequences.  The
  11.             TERM environment variable is also checked for AT386 which
  12.             enables a different decoding of keyboard escape sequences.
  13.  
  14.       UUCPLOCK If UUCPLOCK contains "/usr/spool/locks/LCK.." ZCOMM uses
  15.             "Honey Danber" uucp port arbitration conventions.
  16.  
  17.  
  18.       16.3  Dialing in to Unix
  19.  
  20.       Unix flavors may be used for dial-in applications to transfer files
  21.       and commands with programs logged in to terminal ports.  The commands
  22.       rz, sz, rb, sb, rx, rc, sx, zcommand, and zcommandi perform the same
  23.       functions as the corresponding ZCOMM commands.  They may be given
  24.       directly to the shell or executed from a shell script or Makefile.
  25.  
  26.       EXAMPLE: sz -Yn *.c *.h
  27.  
  28.  
  29.       The Makefile fragment below commands a DOS ZCOMM logged into a serial
  30.       port to clear its dirrx string parameter, change to its root
  31.       directory, and then sends a new version of the executable to the DOS
  32.       machine.
  33.  
  34.       EXAMPLE: cpsz:/tmp/yam.exe
  35.                       @zcommand 'set dirrx ""'
  36.                       @zcommand "c:;cd /"
  37.                       @sz -y /tmp/yam.exe
  38.  
  39.  
  40.       More general command sequences or other protocols such as Kermit may
  41.       be accessed with the xyam command.
  42.  
  43.       EXAMPLE: xyam kermit sb *.c *.h
  44.  
  45.  
  46.       EXAMPLE: xyam z pl256 sz -Yn *.c *.h
  47.  
  48.  
  49.       If a many files are specified with wild cards, the shell may not be
  50.       able to pass them to ZCOMM.  The following error will appear:
  51.       /usr/bin/sz: arg list too long
  52.       ZCOMM users can avoid this problem by letting ZCOMM do the wild card
  53.       expansion internally.
  54.  
  55.       EXAMPLE: sz '*'
  56.  
  57.  
  58.       (C) 1993 Omen Tech Inc                       Chapter 16 Running ZCOMM
  59.  
  60.  
  61.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                   92
  63.  
  64.       16.3.1  Initialized Logins  When a user logs in, the Unix shell
  65.       executes commands in .profile in the user's home directory.  This can
  66.       be used to accept file(s) from callers, send file(s), perform suitable
  67.       processing, and log out the user automatically.
  68.  
  69.       The following .profile disables hangup and interrupt signals, then
  70.       invokes xyam to execute commands in a script.
  71.  
  72.       set -e
  73.       trap "" 1 2 3
  74.       xyam source inbound.t
  75.       exit
  76.  
  77.       The following inbound.t receives a file from a hand held aviation
  78.       recorder.
  79.  
  80.                       echo "Send XMODEM file"
  81.                       ena -d
  82.                       rx -y airlink.tmp
  83.                       if ? echo "File Received"
  84.                       if !? echo "Sorry."
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.       (C) 1993 Omen Tech Inc                     Chapter 16 Commands Outline
  118.  
  119.  
  120.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                   93
  122.  
  123.       17.  OUTLINE OF COMMANDS
  124.  
  125.  
  126.  
  127.       17.1  Setup
  128.  
  129.       port 1 ..........................Select the modem port
  130.       portx hbase,vec .................Select non standard modem
  131.       speed 1200 ......................Set the "baud rate"
  132.       handshake {on|off|cts|dsr|dcd|both|slow}Hardware flow control
  133.  
  134.  
  135.       17.2  Data Call
  136.  
  137.       queue............................Manipulate a dialing queue
  138.       call [-N] system ................[N retries]
  139.       234-5678 ........................Dial a local number
  140.       234-5678/mnp ....................Dial a local number with MNP
  141.       %l-503-621-3746 .................Dial long distance
  142.       learn lfile .....................TurboLearn information to lfile
  143.       xpc C ... .......................Enable and control virtual channels
  144.       with X.PC
  145.       bye .............................Disconnect current call
  146.       off .............................Disconnect and exit
  147.       String parameters: phones, mcommand, mprefix, msuffix, mconnect
  148.  
  149.  
  150.       17.3  Interactive Operation
  151.  
  152.       F2, t [-options] ................Begin terminal conversation
  153.       learn lfile .....................TurboLearn information to lfile
  154.       conf ............................Online conference with edit window
  155.       F8 ..............................Generate a password
  156.       enable -options .................Modify term function characteristics
  157.       history histfile.................Enable command recall history
  158.       set .............................Assigns a string or command to a
  159.       function key
  160.       String parameters: break, bs, esc, etx, xpassword, entstr, lpnono
  161.  
  162.  
  163.       17.4  Message Transfer Commands
  164.  
  165.                            Normal Interactive Transfers
  166.       f [-options] file ...............Send file with the term function
  167.       t [-options] file ...............Terminal conversation with capture to
  168.       file
  169.       kill ............................Erase the contents of the circular
  170.       buffer
  171.       w, ALT-W ........................Write the circular buffer
  172.       close, ALT-C ....................Close the capture file
  173.       Term Function Options ...........(capture/send modifiers)
  174.  
  175.  
  176.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  177.  
  178.  
  179.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                   94
  181.  
  182.       String parameters: eolstr, blankfill
  183.                               Special File Transfers
  184.       fput ............................High Speed file dump to modem
  185.       fpute ...........................Send file with Echoplex check
  186.       fget ............................High speed modem to disk data dump
  187.  
  188.  
  189.       17.5  Protocol File Transfer Commands
  190.  
  191.       F3, rb [-options] [dir] [file ...] Receive files with YMODEM or Clink
  192.       rz [-options] [dir] [file ...] ..Receive files with ZMODEM
  193.       kermit rb [-options] ............Receive files with Kermit
  194.       rx [-options] rxfile ............Receive a file with XMODEM
  195.       rt [-options] [dir] [file ...] ..Receive files with Telink/FIDO
  196.       r7 [-options] [dir] [file ...] ..Receive files with MODEM7
  197.       ro [-options] rxfile ............Receive a file with XMODEM
  198.       OverThruster
  199.       rw [-options] rxfile ............Receive a file with WXMODEM
  200.       rc [-options] rxfile ............Receive a file with XMODEM/CRC
  201.       sz [-options] txfile ... ........Send file(s) with ZMODEM
  202.       sb [-options] txfile ... ........Send file(s) with YMODEM or Clink
  203.       sx [-options] txfile ............Send a file with XMODEM or XMODEM/CRC
  204.       st [-options] txfile ... ........Send file(s) with Telink/FIDO
  205.       s7 [-options] txfile ... ........Send file(s) with MODEM7
  206.       zcommand COMMAND ................Remote COMMAND with ZMODEM
  207.       !!COMMAND........................Remote COMMAND with Kermit or ZMODEM
  208.       kermit sb [-options] txfile ... .Send file(s) with Kermit
  209.       Kermit Server Access Commands
  210.       AUTOMATIC File Transfers.........(Compuserve-B, Kermit, ZMODEM)
  211.       String parameters: adlopts
  212.       Options for Protocol File Transfers
  213.       Numeric Parameters for XMODEM/YMODEM/ZMODEM Transfers
  214.       Special Keys for Protocol Transfers
  215.  
  216.       17.6  Macro Commands
  217.  
  218.       call system .....................Execute telephone directory entry
  219.       r [oldcmd] ......................Reenter previous command
  220.       Up, Down ........................Select previous commands for reentry
  221.       source scriptfile ...............Call subroutine
  222.       set .............................Assign a string or command to a
  223.       function key
  224.       keys ............................Display soft key definitions
  225.       reskeys .........................Clear soft key definitions
  226.       SOFT KEYS .......................Transmit strings or execute commands.
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  236.  
  237.  
  238.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                   95
  240.  
  241.       17.7  Display Commands / Terminal Emulation
  242.  
  243.       display displaymodes ............Set CRT parameters, screen emulation
  244.       cl, cls .........................Clear the Screen
  245.       mk...............................Map keys for terminal emulation
  246.       videobios N .....................Set video BIOS mode N (for 132 cols)
  247.  
  248.  
  249.       17.8  Disk/File Access Commands
  250.  
  251.       a: ..............................Change default disk
  252.       ap file1 file2 ..................Append file1 to file2
  253.       apd file1 file2 .................Append file1 to file2, delete file1
  254.       cd directory ....................Change directory
  255.       cdd D:dir .......................Change disk and directory
  256.       dir[rlstx] ......................Sorted directory listings
  257.       !DOS-command ....................DOS Gateway to another program
  258.       browse file .....................Browse a set of files
  259.       crc file ... ....................Display 32 bit file CRC's
  260.       del file ........................Delete files from disk
  261.       dump file ... ...................Side by Side HEX/ASCII file dump
  262.       egrep regular-expression file ... Pattern matching file searching
  263.       egrepq regular-expression file ... String extraction
  264.       find string file ... ............Case insensitive file searching
  265.       findq string file ... ...........String extraction
  266.       list file ... ...................List files on DOS standard output
  267.       page file ... ...................Pauses after each screenful
  268.       read file .......................Fill circular buffer from open file
  269.       seek [-]offset ..................Seek to location in file
  270.       Home, End, PgUp .................Enter review function
  271.       sum file ... ....................Display Unix style file checksum
  272.       typ file ... ....................Type (display) files on screen
  273.       wc file ... .....................File character, word, line count
  274.       <file ...........................Simulate keyboard input from file
  275.       >outfile ........................Redirect utility command output
  276.       >>file ..........................Add utility command output to file
  277.  
  278.  
  279.       17.9  Remote Takeover / Control
  280.  
  281.       host ............................Enter Host Operation
  282.       link ............................Connect to another computer
  283.       message .........................Leave a public message
  284.       private .........................Leave a private message
  285.       remote ..........................Accept remote commands
  286.       unrestrict.......................Allow caller unrestricted access
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  295.  
  296.  
  297.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                   96
  299.  
  300.       17.10  Support Commands
  301.  
  302.       bdump file ......................Dump interrupt input buffer to file
  303.       display displaymodes ............List or change CRT operation
  304.       enable -options..................Modify term function operation
  305.       exit ............................Exit to DOS
  306.       help ............................Activate help database
  307.       kbdlock on|off ..................Lock/Unlock keyboard
  308.       kbdmon [file] ...................Monitor keystrokes in file
  309.       p ...............................Set/display numeric parameters
  310.       reset............................Reset display and disk system
  311.       set .............................Set string parameters / soft keys
  312.  
  313.  
  314.       17.11  Record Keeping Commands
  315.  
  316.       nolog ...........................Inhibit next log entry
  317.       timestamp .......................Display/write time and other info
  318.       restime .........................Reset elapsed time counter to 0
  319.       String parameters: calllog, txlog, rxlog, plog, rxcnt
  320.  
  321.  
  322.       17.12  Script Commands
  323.  
  324.       abort ...........................Returns to command prompt
  325.       accept ..........................Read keyboard response to string
  326.       variable
  327.       bg...............................Indicate background operation
  328.       createx file ....................Exclusive file creation (for
  329.       semaphores)
  330.       echo ............................Display message
  331.       fg...............................Indicate foreground operation
  332.       kill [-signum] procnum ..........Interprocess communications
  333.       lput string .....................Local screen write
  334.       lputp string ....................Output string to printer
  335.       expand script pathspec ..........Execute script for each file in
  336.       pathspec
  337.       fail ............................Failure return from script
  338.       gosub name[.file] ...............Script subroutine call
  339.       goto ............................Branch to label in same script.
  340.       grab svar .......................Read line from file to string
  341.       variable
  342.       if, else.........................Execute rest of line conditionally
  343.       kbdlock on|off ..................Lock/Unlock keyboard
  344.       ki ..............................Reset capture buffer search area
  345.       on ..............................Conditional execution, tested after
  346.       each command
  347.       pattern .........................Specify string searches in modem data
  348.       purge{k|l} ......................Purge typeahead or modem input buffer
  349.       put[v] ..........................Send string [variable] to modem
  350.       return...........................Return to previous script level
  351.  
  352.  
  353.       (C) 1993 Omen Tech Inc                     Chapter 17 Commands Outline
  354.  
  355.  
  356.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                   97
  358.  
  359.       set[c|s] ........................Set string parameters / soft keys
  360.       setn ............................Set string param to Arithmetic
  361.       expression
  362.       set? ............................Set string param to test value
  363.       sleep ...........................Let the world pass by
  364.       source scriptfile ...............Call scriptfile as a subroutine
  365.       split ...........................Split (parse) a string to tokens
  366.       ss ..............................Regular Expression pattern match
  367.       string parse
  368.       trs .............................Translate characters in a string
  369.       wait ............................Wait for pattern(s) in modem data
  370.       while ...........................Looping control
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.       (C) 1993 Omen Tech Inc                         Chapter 17 Special Keys
  413.  
  414.  
  415.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                   98
  417.  
  418.       18.  SPECIAL KEYS
  419.  
  420.       Ctrl-Break clears typeahead, unlocks the keyboard, and stops the
  421.       function ZCOMM is doing in a reasonably orderly manner.[1] Ctrl-Break
  422.       cancels kbdlock.  Ctrl-Break is not so abrupt as the NUKE key.  The B
  423.       test condition tests whether Ctrl-Break has been struck since the last
  424.       purgek command.
  425.  
  426.       Keyboarding ALT-N will NUKE (abort) the current command and return to
  427.       ZCOMM's command prompt.[2] If one or more scripts are active, the
  428.       current line number (counting from the first line in the script file)
  429.       for each level of script is displayed.* NUKE will terminate any
  430.       script.  NUKE closes any transmit file, but not a receive capture
  431.       file.  (A receive capture file may be closed with the "close"
  432.       command.) NUKE does not disconnect the modem by dropping DTR.[3]
  433.  
  434.       Keyboarding ALT-Z appends the contents of the display screen to a DOS
  435.       file.  The pathname is contained in the picture string parameter.  The
  436.       exact contents of the screen memory are written to the file, with each
  437.       screen character followed by its attribute.  A separate program, unpic
  438.       is used to convert the screen dump to a normal file that may be
  439.       printed or displayed.
  440.  
  441.       SEE ALSO: picture string parameter, unpic program
  442.  
  443.  
  444.       18.1  Special Keys during Protocol Transfers
  445.  
  446.       Certain keys perform special functions when keyboarded during protocol
  447.       file transfers (XMODEM, Kermit, etc.).  Some of these keys are
  448.       inhibited when a non error correcting protocol (YMODEM-g) is active.
  449.  
  450.       F1  Keyboarding F1 causes a protocol timeout and forces a retry.
  451.  
  452.       ALT-A Displays Kermit file transfer status.
  453.  
  454.       ALT-B Cancels the current Kermit or ZMODEM batch transfer.
  455.  
  456.  
  457.  
  458.       __________
  459.  
  460.        1. In the term function, Ctrl-Break sends a break to the remote
  461.           unless it has been redefined with a set command.
  462.  
  463.        2. Use of this term, popularized in the J.F.K. administration, does
  464.           not imply endorsement of preemptive nuclear attacks on innocent
  465.           populations.
  466.  
  467.        3. When in host operation waiting for a call, NUKE drops DTR.
  468.  
  469.  
  470.  
  471.       (C) 1993 Omen Tech Inc                         Chapter 18 Special Keys
  472.  
  473.  
  474.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                   99
  476.  
  477.       ALT-C Cancels the ZMODEM or Kermit session.
  478.  
  479.       ALT-F Skips the current ZMODEM or Kermit file transfer.
  480.  
  481.           SEE ALSO: zmodem w numeric parameter
  482.  
  483.       ALT-Q Keyboarding Alt-Q during a protocol file transfer toggles a flag
  484.           that causes ZCOMM to disconnect when the transfer is completed.
  485.           This is most useful when downloading a long file.  As soon as the
  486.           file is transferred, ZCOMM will execute the string parameter
  487.           quitcmd (if set) and then disconnect the modem.  If keyboarded
  488.           during a Host Operation file transfer, ZCOMM will exit Host
  489.           Operation at the conclusion of the transfer.  The state of the
  490.           quit flag is displayed each time ALT-Q is keyboarded.
  491.  
  492.       ALT-S Keyboarding Alt-S displays status information on the console
  493.           screen only (even if in Host Operation).  The pattern number of
  494.           the last successful search (-1 if no match), the active search
  495.           patterns (if any), and the line numbers of the active scripts (if
  496.           any) are displayed to aid script debugging.
  497.  
  498.       ALT-V Keyboarding ALT-V will toggle the view option affecting the rb,
  499.           rc, rz, sb, sc, sx, and sz commands, and data transfers using the
  500.           Compuserve B protocol.
  501.  
  502.       ASCII Keyboarding a normal ASCII character (in the range of 00 to 7F)
  503.           will send that character to the modem.  This may be used for
  504.           protocol testing, or to terminate a modem's autodial handshake
  505.           without terminating ZCOMM's call retry count.
  506.  
  507.       Ctrl-X All ZMODEM and many YMODEM and XMODEM protocol programs
  508.           recognize a dozen successive Ctrl-X characters as a session abort
  509.           command.  If the remote computer appears to be "stuck" in a YMODEM
  510.           or ZMODEM transfer, keyboard ten Ctrl-X characters to abort the
  511.           protocol transfer.
  512.  
  513.       During a protocol transfer, normal keys are sent to the modem when
  514.       Zcomm is waiting for or receiving a packet.  This may be used to
  515.       reissue a file transfer command to the other computer if it becomes
  516.       apparent the original command was not accepted.
  517.  
  518.       Other uses for this pass thru capability include protocol testing.
  519.  
  520.       18.2  Local Editing Keys
  521.  
  522.       Emacs style character editing reduces the number of keystrokes needed
  523.       to enter and edit commands and strings.  Normally the cursor is at the
  524.       end of the line of text being keyboarded.  Printing characters insert
  525.       themselves at the cursor location.  The <ENTER> key enters/transmits
  526.       the entire line of text.
  527.  
  528.  
  529.  
  530.       (C) 1993 Omen Tech Inc                   Chapter 18 Local Editing Keys
  531.  
  532.  
  533.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                  100
  535.  
  536.       Left, Ctrl-B moves the cursor to the left
  537.  
  538.       Right, Ctrl-F moves the cursor to the right
  539.  
  540.       Ctrl-Left cursor WORD left
  541.  
  542.       Ctrl-Right cursor WORD right
  543.  
  544.       Ctrl-A cursor to beginning of line
  545.  
  546.       Ctrl-E cursor to end of line
  547.  
  548.       Del, Ctrl-D delete character at cursor
  549.  
  550.       Backspace delete character to left of cursor
  551.  
  552.       Ctrl-W delete word to left of cursor
  553.  
  554.       Ctrl-End, Ctrl-K delete to end of line
  555.  
  556.       Ctrl-R refresh (redisplay) the line
  557.  
  558.       Ctrl-X delete entire line
  559.  
  560.       Down, Ctrl-N next history line
  561.  
  562.       Up, Ctrl-P previous history line
  563.  
  564.       Ctrl-U Argument Count (not available in term function)
  565.  
  566.       An initial Ctrl-U sets an argument count of 4.  Successive Ctrl-U
  567.       characters multiply the argument count by 4.  A decimal number may be
  568.       entered after Ctrl-U, and this number becomes the argument count.
  569.  
  570.       EXAMPLE: ^U^U Left moves the cursor 16 left
  571.  
  572.  
  573.       EXAMPLE: ^U5X inserts 5 "X" characters
  574.  
  575.  
  576.       EXAMPLE: ^U5^U?  inserts 20 "?" characters.
  577.  
  578.       Unix/Xenix flavors do not support Emacs style editing in the term
  579.       function.
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.       (C) 1993 Omen Tech Inc                        Chapter 18 Main Commands
  590.  
  591.  
  592.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                  101
  594.  
  595.       19.  MAIN COMMANDS
  596.  
  597.       All commands and arguments must be entered in lower case except where
  598.       stated.
  599.  
  600.       You may shorten some commands by typing just the first portion that is
  601.       shown in caps.  For example, the "break" command may be entered as
  602.       "br".  Whether or not you abbreviate the command, it must be entered
  603.       in lower case.
  604.  
  605.       User defined Soft Keys are executed from the command prompt iff they
  606.       do not conflict with the permanent definitions described below.
  607.  
  608.       Except where stated, multiple commands can be written on one line
  609.       separated by ; (semicolon).  Commands that take a constant number of
  610.       arguments do not need a semicolon to delimit the end of the command.
  611.       If in doubt, use a semicolon to separate multiple commands.[1]
  612.  
  613.       @ The at sign may be used to indicate a telephone number starting with
  614.         the Touch-Tone(TM) A B C D * or # codes or a character escape.  If
  615.         the phone number contains spaces, it must be enclosed in double
  616.         quotes.  The leading @ is not sent to the modem.
  617.  
  618.         EXAMPLE: @#*-123-4567 Dials #*-123-4567.
  619.  
  620.  
  621.       %l-234-567-8901 (%l:letter l) For normal long distance dialing, the
  622.         string parameter l (letter l) defaults to "1" (digit 1).  To use an
  623.         alternative long distance service, set the l string parameter with a
  624.         modem command to dial the local access number, wait for the second
  625.         dial tone, and transmit the account number.
  626.  
  627.         SEE ALSO: "setsavenet" telephone directory entry
  628.  
  629.         A string of alternate phone numbers may be specified with the "+"
  630.         construction shown below.
  631.  
  632.       234-5678 A number given as a command invokes the dial script to
  633.         attempt a connection with the specified number.  Iff the modem is
  634.         currently connected to a remote modem, and the B numeric parameter
  635.         is non zero, ZCOMM pulses Data Terminal Ready, terminating the
  636.         connection.  ZCOMM character escapes may be used within the number
  637.         string to represent special characters.
  638.  
  639.  
  640.  
  641.       __________
  642.  
  643.        1. A space or two after each semicolon makes scripts easier for
  644.           humans to read.
  645.  
  646.  
  647.  
  648.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  649.  
  650.  
  651.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                  102
  653.  
  654.         EXAMPLE: 234-5678
  655.  
  656.  
  657.         When carrier is detected, ZCOMM executes the mconnect string (if
  658.         set).  If there is no next command, ZCOMM returns to the command
  659.         prompt.
  660.  
  661.         One or several alternate phone numbers may be specified by appending
  662.         the previous number with +234-5678 for as many alternate numbers as
  663.         are desired.[2] When a connection is made, undialed alternates are
  664.         forgotten.  Alternate phone numbers need not support the same
  665.         speeds.  A redial count given to the call command repeats the
  666.         sequence of alternate numbers.
  667.  
  668.         EXAMPLE: cis  speed 2400 239-6124/mnp_s+239-6126/mnp_s+232-1032/300
  669.         This script line attempts a MNP (with software flow control) call to
  670.         the first two numbers, then a 300 bps call to the third number if
  671.         neither of the first two connected.
  672.  
  673.  
  674.         Iff no connection is made, script processing at the current level is
  675.         terminated.
  676.  
  677.         A number of modifiers are available depending on the type of modem
  678.         and the choice of dialing script used.  These are described in
  679.         Chapter 8.
  680.  
  681.  
  682.         SEE ALSO: nolog command, calllog string parameter, mcommand string
  683.         parameter
  684.  
  685.       a: Change the default disk to a:.  ZCOMM then prints the free storage
  686.         remaining on the selected disk.  The specified disk must be included
  687.         in the string parameter disks.
  688.  
  689.       abort Aborts any command or script in progress.  Closes all script
  690.         files that may be open.  Abort returns to the command prompt.
  691.  
  692.         SEE ALSO: quit command
  693.  
  694.       accept[[l]1] stringvar prompt (letter l, digit 1) Scripts often need
  695.         to prompt the user for file names and menu choices.
  696.  
  697.         Accept displays Prompt[3] to the user.  ZCOMM then reads keyboard
  698.  
  699.  
  700.       __________
  701.  
  702.        2. When using the mm224 dialing script.
  703.  
  704.        3. Prompt must be enclosed in quotes if it contains spaces.
  705.  
  706.  
  707.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  708.  
  709.  
  710.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                  103
  712.  
  713.         input into the specified string variable.  Backspace and Ctrl-U
  714.         perform editing functions.  Characters are accepted from the user
  715.         until <ENTER> is typed.  If the H numeric parameter is non zero, an
  716.         empty string is returned if <ENTER> is not typed within the time
  717.         limit set by that parameter.  Acceptl translates the user's response
  718.         to lower case.  Acceptl1 returns a 1 character string in lower case
  719.         after the single character is keyboarded.
  720.  
  721.         Prompt is processed for string substitution and character escapes.
  722.         If the result begins with an ESC character, ZCOMM does not
  723.         reposition the cursor before accepting the string.  In writing
  724.         scripts, it may be useful to save the current screen location with
  725.         an escape sequence, then restore it with an escape sequence encoded
  726.         in the prompt string.
  727.  
  728.         EXAMPLE: accept s1 File: Displays the prompt File: and reads the
  729.         keyboarded response to string parameter s1.
  730.  
  731.  
  732.         EXAMPLE: acceptl1 s0 "Enter Menu Choice" Reads a single character
  733.         from the user, translates it to lower case, and assigns it to s0.
  734.  
  735.  
  736.         EXAMPLE: accept s0 "\E[20;60H\E[KFile Name: " Places the cursor at
  737.         line 20 column 60, clears the rest of the CRT line, displays the
  738.         prompt, and accepts input.
  739.  
  740.  
  741.         EXAMPLE: accept s6 " Your \E[1mFirst\E[0m name please " Uses
  742.         boldface video to highlight First as it appears in the prompt.
  743.  
  744.  
  745.         EXAMPLE: accept s2 "File "; rc %s2 Prompts the user for a file name,
  746.         then receives that file with XMODEM/CRC protocol.
  747.  
  748.  
  749.         EXAMPLE: accept xpassword "\E[mMaster Password: \E[8m"; lput "\E[m"
  750.         Uses invisible video (ESC [ 8 m) to allow a password to be entered
  751.         without visible echo.  The ESC [ m sequences reset the display to
  752.         normal (visible).
  753.  
  754.  
  755.         SEE ALSO: obey command, scripts
  756.  
  757.       ap file1 file2* (Append) Appends the contents of file1 to file2.  If
  758.         file2 does not exist, it is created.  Wildcards are not allowed.
  759.         The ap command may close files that have been opened by the create,
  760.         f, open, t or > commands.  File1 and file2 are processed for string
  761.         parameter substitution.
  762.  
  763.  
  764.  
  765.  
  766.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  767.  
  768.  
  769.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                  104
  771.  
  772.       apd file1 file2* (Append-Delete) Appends the contents of file1 to
  773.         file2, then deletes file1.  If file2 does not exist, it is created.
  774.         If an error is detected writing file2, file1 is not deleted.
  775.         Wildcards are not allowed.  The apd command may close files that
  776.         have been opened by the create, f, open, t or > commands.  File1 and
  777.         file2 are processed for string parameter substitution.
  778.  
  779.         EXAMPLE: apd %item Z%item.tmp
  780.  
  781.  
  782.       bdump outfile Dumps the contents of the modem interrupt input buffer
  783.         to outfile.  This command is useful for debugging as outfile will
  784.         contain the last characters received from the remote regardless of
  785.         what ZCOMM commands have been executed.  The most recently received
  786.         data appears at the end of outfile.  This command "tells it as it
  787.         is", writing all 8 bits of each character to outfile.  If few
  788.         characters have been received from the remote, some of outfile will
  789.         consist of nulls or garbage.  The bdump command is often used as a
  790.         post mortem diagnostic dump after a failed script or file transfer.
  791.         This command is not available on OS/2, and X.PC flavors of ZCOMM.
  792.  
  793.       bg Indicates ZCOMM is running in the background with no user at the
  794.         keyboard.
  795.  
  796.         SEE ALSO: fg command, df test condition
  797.  
  798.       BReak Sends a 200 millisecond break signal.
  799.         N.B.: Some modems do not correctly pass the break signal to the
  800.         remote.
  801.  
  802.         SEE ALSO: Ctrl-Break key, break string parameter, zmodem B numeric
  803.         parameter
  804.  
  805.       BROwse pathspec Browse through the files specified in pathspec.  If
  806.         pathspec is empty, all files are presented.  For each matched
  807.         pathname, the filename, date, and length of the file are displayed.
  808.         The status line displays some of the commands which may be applied
  809.         to each file.  Chapter 19.4 describes the browse subcommands, which
  810.         provide extensive capabilities for individually selected files.
  811.  
  812.       bye Terminate the connection in progress by sending a long space and
  813.         then dropping DTR (Data Terminal Ready).[4] After a pause, DTR is
  814.         reasserted to allow the modem to originate or answer another
  815.         call.[5]
  816.  
  817.  
  818.       __________
  819.  
  820.        4. The modem must be configured to use Data Terminal Ready (DTR).
  821.  
  822.        5. Most dialing scripts include an initial bye command to make sure
  823.  
  824.  
  825.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  826.  
  827.  
  828.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                  105
  830.  
  831.         SEE ALSO: o, off commands
  832.  
  833.       call [-N] [name][.directory][,modifier] Prepare ZCOMM for a new task
  834.         and invoke an entry in the Phone Directory.  If directory is
  835.         specified, it is searched instead of the regular Phone Directory.
  836.         An optional modifier (string with a leading comma), may be added; it
  837.         is passed to the script.
  838.  
  839.         The 7, A, a, b, C, c, E, e, g, H, h, i, j, n, o, P, p, q, r, S, s,
  840.         t, u, v, w, X, x, Z, and z term options are reset.  The d term
  841.         option is set.  The e, f, g, k, m, p, q, t, w, Kermit 8, zmodem C,
  842.         e, l, L, p, t, T, w, and W parameters are reset to their default
  843.         values.  The search patterns are erased.  Permanent string
  844.         parameters set with the set _svar command are set to empty.
  845.  
  846.         If the search is successful, the entire directory entry name is
  847.         copied to the remote string parameter.  The complete argument
  848.         entered on the command line is stored in the args string parameter
  849.         visible to the called script.  If the script has a READ ONLY
  850.         attribute, ZCOMM is unrestricted during execution of the script.
  851.         ZCOMM then executes the commands on the rest of the line (if any),
  852.         and on succeeding lines beginning with a space or tab.  If the v
  853.         numeric parameter is greater than zero, each command from the file
  854.         is displayed on the screen before it is executed.
  855.  
  856.         It is not necessary to type the entire name as it appears in the
  857.         telephone directory, as ZCOMM will find the first entry that name is
  858.         a prefix of.  Iff name is empty, execution begins with the first
  859.         line of path.
  860.  
  861.         EXAMPLE: call cis1200
  862.              call cis1
  863.              call cis.C:/newscript
  864.  
  865.  
  866.         EXAMPLE: call genie,upl Invokes the genie telephone directory entry
  867.         with the modifier ,upl available to the called script.
  868.  
  869.         The call command is not limited to making connections.  For example,
  870.         "call host" in the distribution PHODIR.t file conditions a Hayes
  871.         compatible modem to answer incoming calls silently, set parameters,
  872.         and activates ZCOMM's host operation.
  873.  
  874.         Most directory entries include a telephone number to dial.  If ZCOMM
  875.         is used with an autodial modem, the number of retries N (default
  876.  
  877.  
  878.       ______________________________________________________________________
  879.  
  880.           any previous call is disconnected.
  881.  
  882.  
  883.  
  884.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  885.  
  886.  
  887.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                  106
  889.  
  890.         none) may be specified.
  891.  
  892.         EXAMPLE: call -40 cbbs-r Attempts 40 retries before giving up.
  893.  
  894.         The interval between retries is set by the i numeric parameter.
  895.  
  896.         EXAMPLE: pi4 Sets the interval between retries to 4 seconds.
  897.  
  898.         Words To the Wise: Abuse of the retry feature by continually calling
  899.         busy numbers may incur the wrath of the Telephone Company.
  900.         Especially with Message Unit Accounting, Big Brother may be watching
  901.         your telecommunications habits.  Some long distance services (MCI,
  902.         Sprint, AT&T, etc.) charge for unsuccessful calls, especially if the
  903.         phone is allowed to ring (or ring busy) for more than a few seconds.
  904.  
  905.         Consult your telephone company about legal limits to the number and
  906.         frequency of retries.
  907.  
  908.         Since some computer services will disconnect within a short time if
  909.         no login is attempted, you should start communicating as soon as the
  910.         modems are connected.  ZCOMM sounds the bell after making the
  911.         connection if retries have been specified.
  912.  
  913.         The source, gosub and call commands may be nested with up to six
  914.         command/phones file descriptors open at once.[6] A label may be the
  915.         target of a call command provided the trailing colon is included in
  916.         name.
  917.  
  918.       cat pathspec For Unix users, a synonym to the type command (q.v.).
  919.  
  920.       cd [dir] Change to directory dir.  If Restricted, dir is checked for a
  921.         parent directory ("cd  .."), and absolute paths ("cd  /src") not
  922.         prefixed by the home string parameter.  Giving cd without an
  923.         argument changes to the directory stored in the home string
  924.         parameter.[7] ZCOMM then stores the current directory in the pwd
  925.         string parameter and displays it unless the v numeric parameter is
  926.         less than 0.
  927.  
  928.         EXAMPLE: cd  /tmp
  929.  
  930.         N.B.: When operating restricted, the home string parameter must
  931.  
  932.  
  933.       __________
  934.  
  935.        6. Deep nesting may require a decrease in the circular buffer memory
  936.           allocation, see Chapter 16.
  937.  
  938.        7. The home parameter is set to the current directory when ZCOMM is
  939.           invoked, but may be changed with the set command.
  940.  
  941.  
  942.  
  943.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  944.  
  945.  
  946.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                  107
  948.  
  949.         point to a valid directory in order to enforce the intended
  950.         directory path restriction.
  951.  
  952.         SEE ALSO: cdd and pwd commands, home and pwd string parameters
  953.  
  954.       cd  D:dir When a disk drive is specified with the cd command, the
  955.         current directory on that drive is changed but ZCOMM remains logged
  956.         in on the current drive and directory.  If Restricted, dir is
  957.         checked for a disk drive ("cd  b:/foo") not contained in the disks
  958.         string parameter.
  959.  
  960.         EXAMPLE: cd D:/tmp
  961.  
  962.  
  963.       cdd D:dir Change to (log in to) disk D and then to directory dir on
  964.         the specified disk.  If dir is not specified, the root directory is
  965.         assumed.  ** This is a shorthand equivalent to a D: command followed
  966.         by a chdir dir command.
  967.  
  968.         SEE ALSO: cd command
  969.  
  970.       chat Enter the term function to chat keyboard to keyboard.  Characters
  971.         typed by either keyboard are echoed to both ends, and RETURNS echo
  972.         as RETURN/LINEFEED.  In Host Operation, chat exits if the caller
  973.         types Ctrl-Z.
  974.  
  975.         Chat will become hostile if the other end also echoes characters.
  976.         (Try it sometime on a timesharing system; it's fun.)
  977.  
  978.       close Writes the contents of the circular buffer iff a receive file is
  979.         open, then closes the receive and transmit files.  ZCOMM complains
  980.         if no files were open.
  981.  
  982.         SEE ALSO: nolog command
  983.  
  984.       closerx Iff a receive file is open, writes the circular buffer then
  985.         closes the receive file.
  986.  
  987.         SEE ALSO: nolog command
  988.  
  989.       closetx Closes the transmit file, if it is open.
  990.  
  991.         SEE ALSO: nolog command
  992.  
  993.       cl Clears the screen.
  994.  
  995.       cls Resets display modes and clears the screen.
  996.  
  997.       CONFerence Enters the term function with a 1 line window for composing
  998.         commands and text.  Chapter 21.5 gives details.
  999.  
  1000.  
  1001.  
  1002.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1003.  
  1004.  
  1005.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                  108
  1007.  
  1008.       crc pathspec Print the CRC-32 and character count for the specified
  1009.         files.  The crc command verifies the identity of two (or more)
  1010.         copies of a file.  Iff the lengths and CRC-32's of two files are the
  1011.         same, the files are almost certainly identical.  Comparing files
  1012.         with the crc command is faster than transmitting a second copy for
  1013.         character by character comparisons.
  1014.  
  1015.         EXAMPLE: "crc", "crc *.c"
  1016.  
  1017.         HINT: To generate a file containing the CRC's of the files in the
  1018.         current directory:
  1019.  
  1020.              >crc.lst
  1021.              crc *.*
  1022.              close
  1023.  
  1024.         After the files are copied, run the commands above (with a different
  1025.         file name), then compare the two files with DIF.EXE to detect any
  1026.         that have changed.
  1027.  
  1028.         SEE ALSO: sum, wc commands
  1029.         Source for a public domain Unix/DOS version of CRC is available.
  1030.  
  1031.       create [-term_options] outfile If a receive capture file is open as
  1032.         the result of a create or t filename command, write the circular
  1033.         buffer and close it.  Then create outfile for use with the term
  1034.         function with options.  The create command is especially useful when
  1035.         you don't want to enter the term function immediately.
  1036.  
  1037.         EXAMPLE: create -ys /tmp/cbbs.tmp[8]
  1038.  
  1039.  
  1040.         SEE ALSO: > command
  1041.  
  1042.       createx outfile Similar to the create command, but does not open
  1043.         outfile if a file with the same pathname already exists.  The
  1044.         resulting error message may be suppressed by setting the v numeric
  1045.         parameter negative.  Scripts may test for success with the r test
  1046.         condition.  The createx command may be used to manage semaphores to
  1047.         lock resources or work entries used by multiple instances of a
  1048.         program.  The createx command is available on Unix and OS/2 flavors.
  1049.  
  1050.         SEE ALSO: kill command
  1051.  
  1052.  
  1053.       __________
  1054.  
  1055.        8. The y option overwrites any existing file with the same name.  The
  1056.           s term option strips most control characters from the resulting
  1057.           disk file.
  1058.  
  1059.  
  1060.  
  1061.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1062.  
  1063.  
  1064.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                  109
  1066.  
  1067.       del pathspec Delete the specified files.  No message is printed if one
  1068.         or more of the specified files could not be deleted.  No
  1069.         confirmation is requested for mass deletes.
  1070.  
  1071.         WARNING: As with all ZCOMM pathspec specifications, a directory name
  1072.         expands to all files in that directory.
  1073.         N.B.: Do not attempt to delete an open file on DOS, especially the
  1074.         history file.
  1075.  
  1076.         SEE ALSO: browse command
  1077.  
  1078.       demand password Scripts must often verify a caller's identity by
  1079.         asking for a password.  The ZCOMM password command allows a caller
  1080.         three chances to enter a given password.  Failure results in
  1081.         disconnection.
  1082.  
  1083.         Password is processed for character escapes and string
  1084.         substitutions.  All security restrictions on string parameters are
  1085.         enforced.
  1086.  
  1087.         If the result is empty, no password is demanded.  Otherwise the user
  1088.         is prompted to enter a string matching password in the correct case.
  1089.         Keyboard input is not echoed.
  1090.  
  1091.         Three attempts to enter password are allowed.  If the password is
  1092.         not correctly entered, DTR is pulsed to force the modem to
  1093.         disconnect the caller, and the ?  numeric parameter is set negative.
  1094.  
  1095.         EXAMPLE: demand %password Requires the caller to enter a string
  1096.         matching the contents of the password string parameter.
  1097.  
  1098.  
  1099.       dir pathspec Display pathnames matching pathspec alphabetized across
  1100.         the page.  Wildcard filename expansions are alphabetical.
  1101.  
  1102.         EXAMPLE: dir
  1103.  
  1104.  
  1105.         EXAMPLE: dir y*.c *.h
  1106.  
  1107.  
  1108.       dirr pathspec Displays the directory with length and creation date of
  1109.         each file.  dirr displays the number of files matched, number of
  1110.         blocks, number of kb in those files, and estimated transmission time
  1111.         at the current transmission speed assuming the fastest protocol
  1112.         available (ZMODEM or YMODEM-g).  XMODEM and Kermit transfers take
  1113.         longer than the displayed estimates.  Wildcard filename expansions
  1114.         are alphabetical.
  1115.  
  1116.       dird pathspec Long Form directory, sorted by date.
  1117.  
  1118.  
  1119.  
  1120.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1121.  
  1122.  
  1123.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                  110
  1125.  
  1126.       dirt pathspec Long Form directory, reverse sorted by date.
  1127.  
  1128.       dirl pathspec Long Form directory, sorted by file length.
  1129.  
  1130.       dirs pathspec Long Form directory, reverse sorted by file length.
  1131.  
  1132.       dirx pathspec Long Form directory, sorted by file extension.
  1133.  
  1134.       DISable{-term_options} Disable options(s) affecting the term function.
  1135.         Chapter 22 describes options affecting the term function.
  1136.  
  1137.         EXAMPLE: dis -t Disables throttle (t term option).
  1138.  
  1139.  
  1140.       display [[no]dismode] ... Without an argument, prints the display
  1141.         modes.  Display modes preceded by NO are turned off.  With one or
  1142.         more arguments, turn on the specified display mode(s).  If an
  1143.         argument is preceded by no, the specified display mode is turned
  1144.         off.
  1145.  
  1146.         If an emulation is specified, it must be the first argument.
  1147.         display command argument changing the terminal emulation (vt100,
  1148.         dasher, lsi-adm3a, 3101, wyse, dumb) disables nlmode and overstrike.
  1149.  
  1150.         The display modes are:
  1151.  
  1152.         vt100 Emulate VT-100, VT-102, SCO Console, and most VT-220 and
  1153.               Teletype 5425 codes.  VT-52 and Zenith H-19 codes are the
  1154.               default.
  1155.  
  1156.               SEE ALSO: 101.MK,STD.MK, script files
  1157.  
  1158.         lsi-adm3a Emulate Lear Siegler ADM3a and Televideo 9xx control
  1159.               codes.
  1160.  
  1161.         dasher Emulate Data General Dasher terminals.
  1162.  
  1163.         3101  Executes IBM 3101 and TI 940 escape codes.
  1164.  
  1165.         wyse  Emulate Wyse terminals in native mode, allow switching the
  1166.               keyboard to keyscan mode.
  1167.  
  1168.               SEE ALSO: WYS.MK script file
  1169.  
  1170.         dumb  Only null, bs, tab, cr and lf are executed, all others
  1171.               display.  As in real life, dumb takes precedence over vt100,
  1172.               vt52, and lsi-adm3a emulation.
  1173.  
  1174.         inhibit Inhibits the display (nothing prints).
  1175.  
  1176.               SEE ALSO: Q term option
  1177.  
  1178.  
  1179.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1180.  
  1181.  
  1182.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                  111
  1184.  
  1185.         nlmode Received newlines (linefeed) display as return/linefeed.  The
  1186.               Enter key is sent as CR/LF.
  1187.  
  1188.         bell=visual Instead of sounding on the speaker, bell characters
  1189.               cause flashing notes to appear on the screen.
  1190.  
  1191.         overstrike Overstruck characters are displayed in bold face or
  1192.               underline (reverse video on CGA) as appropriate.
  1193.  
  1194.         autowrap The 81st character prints on a new line with possible
  1195.               scrollup.
  1196.  
  1197.         rautowrap Allow a backspace from the lest margin to reverse wrap to
  1198.               the last character position on the previous line.
  1199.  
  1200.         8bit  Decode 8bit control characters and G1 character set.
  1201.  
  1202.         stat=off Disables ZCOMM's status line.
  1203.  
  1204.         warpdrive Provides higher display speed without scrolling flicker,
  1205.               but causes noise (snow/chromablizzard) with CGA display
  1206.               adapters.
  1207.  
  1208.         mapkb Allow escape codes from the remote or a file to active
  1209.               alternate keyboard mapping.  The keyboard mapping is defined
  1210.               with a series of mk commands, such as those contained in the
  1211.               std.mk (standard keyboard) or 101.mk (101 key extended
  1212.               keyboard) files.  Other XXX.mk files may be provided; the
  1213.               first few lines of these files indicate the keyboard
  1214.               configuration they set up.  ZCOMM comes initialized with the
  1215.               std.mk mapping, which requires NumLock to be on.
  1216.  
  1217.               EXAMPLE: source std.mk Defines a VT100 keyboard mapping for
  1218.               standard PC and PC-AT keyboards.
  1219.  
  1220.               The term function keyboard mapping enabled by the mapkb
  1221.               command may override some ZCOMM functions.
  1222.         A display nlmode nobell=visual Turns on nlmode display mode and
  1223.         turns off the visual bell.
  1224.  
  1225.  
  1226.         EXAMPLE: display vt100 Enables VT100/VT102 emulation used by many
  1227.         computer systems.
  1228.  
  1229.  
  1230.         SEE ALSO: tcs command
  1231.  
  1232.       dump pathspec Dump the named files in a side by side hex/ASCII format,
  1233.         similar to the CP/M users' group DUMP program.  The ending character
  1234.         number is also displayed.  Zero length files are not displayed.
  1235.  
  1236.  
  1237.  
  1238.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1239.  
  1240.  
  1241.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                  112
  1243.  
  1244.       echo[c|f] [-n] string Echo a line containing a single argument string
  1245.         in reverse video.  The optional -n suppresses reverse video and
  1246.         linefeeds.  Tabs should not be used with the echo command.  The
  1247.         echoc command also echoes its argument to the capture file (if
  1248.         open), without reverse video.  The echof command echoes its argument
  1249.         to the capture file only.
  1250.  
  1251.         EXAMPLE: echoc "File not Accepted" Outputs a line to the screen and
  1252.         to the capture file.
  1253.  
  1254.  
  1255.         EXAMPLE: echo "Dave, This conversation can serve no further
  1256.         purpose." Displays a line on the screen only.
  1257.  
  1258.  
  1259.         SEE ALSO: lput command, r numeric parameter, character escapes
  1260.  
  1261.       egrep[m] regular-expression pathspec ** Display lines in the specified
  1262.         files matching regular-expression.  Regular Expressions are
  1263.         discussed in Chapter 26.
  1264.  
  1265.         The egrepm command finds a line matching regular-expression in each
  1266.         of the specified files, and then pages through the file beginning
  1267.         with the matched line.  At the end of each screen, ZCOMM accepts the
  1268.         same subcommands used with the findm command.
  1269.  
  1270.         EXAMPLE: egrep "^Subject:" *.* Displays all lines that begin with
  1271.         "Subject:".
  1272.  
  1273.  
  1274.         SEE ALSO: findmore command
  1275.  
  1276.         The egrep implementation does not strip the trailing CR/LF from
  1277.         lines read from the disk.  This affects use of the $ regular
  1278.         expression magic character.  When using the $ magic character, the
  1279.         CR/LF at the end of normal lines must be represented as "..$".
  1280.  
  1281.       egrepq regular-expression pathspec ** Silently searches the specified
  1282.         files for the first line matching regular-expression.  Upon a
  1283.         successful search, the contents of this line are stored in the z0
  1284.         string variable and the ?  numeric parameter is incremented.  The
  1285.         egrepq command is useful for fetching password information from a
  1286.         disk file.
  1287.  
  1288.         SEE ALSO: obey command, findq command
  1289.  
  1290.       else Execute the command(s) on the rest of the line if the last if
  1291.         test performed on the current script level was false.
  1292.         N.B.: While else statements in programming languages are connected
  1293.         to a particular if statement according to syntax, the connection in
  1294.         ZCOMM is to the last if statement executed on the level, regardless
  1295.  
  1296.  
  1297.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1298.  
  1299.  
  1300.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                  113
  1302.  
  1303.         of goto's.
  1304.  
  1305.       ENAble {-term_options} Enable options affecting the term function.
  1306.         Chapter 22 describes options affecting the term function.
  1307.  
  1308.         EXAMPLE: ena -h Enables half-duplex (local echo) Half-duplex option
  1309.         causes the term function to display keyboarded characters.
  1310.  
  1311.  
  1312.       estimate length [speed] Use the specified length and optional
  1313.         specified effective speed when displaying information for the next
  1314.         receive file.  A length of 0 bypasses the length substitution.  Once
  1315.         a speed (in effective bits per second) is given, it is used for all
  1316.         locally displayed transmission time calculations until the next
  1317.         speed or port command.
  1318.  
  1319.         EXAMPLE: estimate z2 Uses the file length stored in string variable
  1320.         z2 in calculating the transmission time estimate for the next
  1321.         received file.
  1322.  
  1323.  
  1324.         EXAMPLE: speed 19200; estimate 0 2400 Use an effective transmission
  1325.         speed of 2400 for transmission time estimates instead of the 19200
  1326.         bps interface speed.
  1327.  
  1328.  
  1329.       exit [code] Exit to the operating system with optional code.
  1330.  
  1331.         SEE ALSO: x, o, off commands
  1332.  
  1333.       EXPand sourcefile pathspec ** For each pathname in pathspec, execute
  1334.         the commands in sourcefile with the string parameter item set to the
  1335.         current pathname.  The commands in sourcefile must not themselves
  1336.         contain wildcards (* or ?) or directory pathnames.  If no files
  1337.         match pathspec, sourcefile is not executed.  If the script executed
  1338.         has a READ ONLY attribute, ZCOMM is unrestricted during execution of
  1339.         the script.
  1340.  
  1341.         EXAMPLE: expand plxupl 001* Executes the script plxupl once for each
  1342.         file matching the wild card specification 001*.
  1343.  
  1344.  
  1345.         EXAMPLE: expand a *.arc where the file a contains:
  1346.              obey "!pkxarc -v %item >> arclist"
  1347.         lists the contents of all .arc files to arclist.
  1348.  
  1349.  
  1350.         Chapter 99 explains the use of this command in more detail.
  1351.  
  1352.       f [-term_options] file The f (think of "file") command initiates
  1353.         transmission of file with the term function.  One or more term
  1354.  
  1355.  
  1356.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1357.  
  1358.  
  1359.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                  114
  1361.  
  1362.         function options (described in Chapter 22) may be enabled with the
  1363.         optional term_options flag.
  1364.  
  1365.         If q (TWX) option is enabled, transmission pauses until the called
  1366.         system's answerback restarts it with an XON, or until g option is
  1367.         set.  Otherwise, any XOFF induced transmission pause is reset.
  1368.  
  1369.         Once the file has been opened with the f command, a pattern match or
  1370.         keyboarding F1 or ALT-X will exit the term function with file
  1371.         incompletely transmitted.  The rest of the file may be transmitted
  1372.         by the t, F2, or wait commands.
  1373.  
  1374.         EXAMPLE: f -px message Uploads message paced by the p term option,
  1375.         which sends a carriage return and pauses at the end of each
  1376.         transmitted line until the remote responds with the prompt character
  1377.         (default line feed).  The x term option makes the term function
  1378.         return to the script after the file has been transmitted.
  1379.  
  1380.  
  1381.         EXAMPLE: set eolstr "\r."; pp1000; pg58; f -p file Is useful for
  1382.         uploading a prepared message to a CompuServe bulletin boards using
  1383.         the "SIG" editor (not FILGE).  The eolstr setting sends a carriage
  1384.         return and period after each line to prevent the CompuServe software
  1385.         from reformatting the message.  Pp10000 Sets the pause timeout to a
  1386.         long time.  Pg58 Sets the prompt character to ":".  f -p file
  1387.         Transmits the file.
  1388.  
  1389.  
  1390.         SEE ALSO: b, g, p, r, n, t, w, x, X term options, eolstr string
  1391.         parameter, t and wait commands
  1392.  
  1393.       fail Terminate the current expand command, otherwise return from the
  1394.         current script level.
  1395.  
  1396.         If called directly by another level of script, that level is
  1397.         terminated.
  1398.  
  1399.         The fail command also causes the term function to exit, to allow a
  1400.         function key to be programmed with a macro that exits the term
  1401.         function.
  1402.  
  1403.         If called implicitly by a number presented for dialing, fail
  1404.         terminates the current dialing attempt.  If no retries are left, the
  1405.         call is abandoned.
  1406.  
  1407.       fg Indicates ZCOMM is running in the foreground with a user at the
  1408.         keyboard.
  1409.  
  1410.         SEE ALSO: bg command, df test condition
  1411.  
  1412.  
  1413.  
  1414.  
  1415.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1416.  
  1417.  
  1418.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                  115
  1420.  
  1421.       fget outfile * Gets 8 bit raw data from the modem to outfile without
  1422.         any protocol.  No data is displayed on the screen.  Keyboarding F1
  1423.         terminates recording; any other keyboarded character is sent to the
  1424.         remote.  Iff the g numeric parameter is set to to some value other
  1425.         than its default of 10 (line feed), the fget command terminates upon
  1426.         reading and storing a character matching the g numeric parameter.
  1427.         The fget command also terminates recording on loss of carrier detect
  1428.         signal.
  1429.  
  1430.         This command can be used when the flow of data from the remote
  1431.         cannot be regulated.  Do not set the I numeric parameter to a large
  1432.         value if flow control is not used.
  1433.  
  1434.         The maximum rate attainable without loss of data is limited by the
  1435.         maximum interrupt latency of the operating system and active device
  1436.         drivers.  The time required to write a 512 character buffer to disk
  1437.         may also limit the maximum average data rate.  Each 512 character
  1438.         block must be written before the modem interrupt input buffer
  1439.         overflows with new data.  If the startup time for a floppy disk is
  1440.         excessive, better results will be obtained writing to a hard disk or
  1441.         ramdisk[9] if a suitable device is available.  Tests with an IBM
  1442.         Personal Computer, DOS 2.1, and a Maynard Electronics hard disk
  1443.         suggest that no characters are lost at 9600 baud.  (Your results
  1444.         will vary depending on your configuration and programming habits.
  1445.         California estimates lower.)
  1446.  
  1447.         EXAMPLE: fget rawdata
  1448.  
  1449.  
  1450.       find string pathspec Find and display lines containing matches to
  1451.         string in the specified files.  Lower case characters in string
  1452.         match either case; upper case characters in string match upper case
  1453.         characters only.  If string contains spaces, tabs, or semicolon, it
  1454.         must be enclosed by double quote characters.  ZCOMM C style escapes
  1455.         may be used to represent control characters and string parameters to
  1456.         be searched for.  Assuming normal DOS files (with CR/LF at the end
  1457.         of each line), a \n at the beginning of string forces a match to the
  1458.         beginning of a line.  A \r at the end of string (\n if the file(s)
  1459.         have no returns in them) forces a match at the end of the line.
  1460.  
  1461.         The file name being searched and its length are displayed in the
  1462.         status line.  For each line that contains a match to string, the
  1463.         file name (if more than one file), line number, and the text of the
  1464.         line are displayed.
  1465.  
  1466.  
  1467.  
  1468.       __________
  1469.  
  1470.        9. See comments on Extended Memory ramdisks in Chapter 34.
  1471.  
  1472.  
  1473.  
  1474.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1475.  
  1476.  
  1477.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                  116
  1479.  
  1480.         EXAMPLE: find count *.c Finds all occurrences of count or COUNT in
  1481.         the named files.
  1482.  
  1483.  
  1484.         SEE ALSO: egrep command
  1485.  
  1486.       FINDMore string pathspec Findmore finds a line matching string in each
  1487.         of the specified files, and then pages through the file beginning
  1488.         with the matched line.  Otherwise, it is similar to the find
  1489.         command.  When the screen is filled up, the prompt More?  appears.
  1490.         Typing space displays another screenfull.  Typing n skips to the
  1491.         next instance of string that has not yet been displayed.  Typing ^Q
  1492.         or ^S displays one more character from the file.  Typing ^X skips to
  1493.         the next file.
  1494.  
  1495.         SEE ALSO: egrepm, page commands
  1496.  
  1497.       findq string pathspec Silently searches the specified files for the
  1498.         first line matching string.  The processing of string is identical
  1499.         to the find command described above.  Upon a successful search, the
  1500.         contents of this line are stored in the z0 string variable and the ?
  1501.         numeric parameter is incremented.  The findq command is useful for
  1502.         fetching password information from a disk file.
  1503.  
  1504.         SEE ALSO: egrepq command
  1505.  
  1506.       finish Terminates Kermit server operation on the remote system.
  1507.  
  1508.       fput file * Puts data from file to the remote at maximum speed without
  1509.         any protocol.  Flow control as determined by the handshake command
  1510.         and the S numeric parameter is respected.  After each 256
  1511.         characters, the number of characters transmitted is displayed, and
  1512.         the keyboard is polled.  Hitting any key will abort the transfer.
  1513.         This command is useful for testing RS232 peripherals at high rates.
  1514.  
  1515.         EXAMPLE: fput datafile
  1516.  
  1517.  
  1518.       fpute file * Echoplex transmit a file to the remote, waiting for the
  1519.         correct echo to each character transmitted (for Throttle/10
  1520.         seconds).  The echoed character is sent to the CRT screen.  If fpute
  1521.         receives a space as an echo to a tab, fpute waits for the spaces to
  1522.         stop echoing for at least 100 milliseconds before resuming
  1523.         transmission.  Transfer speed thus suffers when tabs are present in
  1524.         the transmitted file unless the remote can be set to echo tabs as
  1525.         tab characters instead of expanding them to spaces.  Throughput is
  1526.         less than 1/3 of normal because of the echo delay.
  1527.  
  1528.         Fpute counts each time the correct character is not echoed as an
  1529.         error.
  1530.  
  1531.  
  1532.  
  1533.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1534.  
  1535.  
  1536.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                  117
  1538.  
  1539.         With n option, fpute transmits only a linefeed at the end of each
  1540.         line.  With r option, fpute transmits only a carriage return at the
  1541.         end of each line.  Most applications would use one of these options.
  1542.  
  1543.         CPMEOF (Ctrl-Z) terminates the file transmission unless b option is
  1544.         set.
  1545.  
  1546.         Because fpute waits for the correct echo to each character sent,
  1547.         fpute should be used for transmitting characters to programs that
  1548.         echo exactly.
  1549.  
  1550.         Often it is easy to write a simple receive routine to synchronize
  1551.         with the sender by echoing each character received.  On some
  1552.         microcomputer systems, the device "TTY:" does just that.  Fpute is
  1553.         especially useful for "spoon feeding" files to the serial inputs of
  1554.         microcomputers and minicomputers.
  1555.  
  1556.         SEE ALSO: f command
  1557.  
  1558.       gcolors bgcolor, color1,... Select colors for the graphic file
  1559.         transfer display provided with ZCOMM and gYam flavors.  On PCDOS
  1560.         (and SCO Unix) flavors, operand values correspond to the video
  1561.         numeric parameters.  This command is normally generated by the
  1562.         gcolors program described in Chapter 13.
  1563.  
  1564.         EXAMPLE: gcolors 15,2,12,120,10,6,14,6,31,7,12,2,14,15,15,0,0
  1565.         selects a color scheme suitable for Aliens III.
  1566.  
  1567.  
  1568.       get filespec Instructs a remote Kermit server to the transmit the
  1569.         specified file(s), then receives them.  The form of filespec varies
  1570.         with the remote system; it must be quoted if it contains any special
  1571.         characters or spaces.  The get command only operates with a Kermit
  1572.         server; use kermit rb to receive files from a regular Kermit
  1573.         program.
  1574.  
  1575.       goback label Search the current script file for label: and execute
  1576.         commands starting at that line.  The goback command begins the
  1577.         search at the beginning of the file.  It is faster than the goto
  1578.         command which begins the search at the current line.
  1579.  
  1580.         SEE ALSO: goto command
  1581.  
  1582.       gosub name[.scriptfile] Call a script as a subroutine.  The phone
  1583.         directory is searched for name unless another file is specified with
  1584.         .scriptfile.  Gosub has the same action as the call command (q.v.),
  1585.         but does not reset term options, disconnect the modem, or modify the
  1586.         remote parameter.
  1587.  
  1588.         EXAMPLE: gosub dosig Executes the dosig entry in the telephone
  1589.         directory.
  1590.  
  1591.  
  1592.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1593.  
  1594.  
  1595.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                  118
  1597.  
  1598.         EXAMPLE: gosub .%lib/baud.t Executes the commands in c:/yam/baud.t
  1599.         assuming the lib string parameter contains c:/yam.
  1600.  
  1601.  
  1602.         SEE ALSO: call command
  1603.  
  1604.       goto label Search the current script file for label: and execute
  1605.         commands starting at that line.  A label begins at the first column
  1606.         and ends with a colon (:).  Iff label precedes the current script
  1607.         line, the goback command will locate the target label more quickly.
  1608.         The goto command is valid only within a script or telephone
  1609.         directory entry.  Please refer to Chapter 99 for examples using the
  1610.         pattern, if, goto, and source commands.
  1611.  
  1612.       grab svar Grab reads a line from the currently open transmit file into
  1613.         the specified string parameter svar.  Unless b term option is on,
  1614.         all characters starting with the first CR and/or LF are discarded.
  1615.         Grab inhibits transmission of the open file until g term option is
  1616.         explicitly set by a command.
  1617.  
  1618.         On end of file the transmit file is closed and the string parameter
  1619.         is set empty.  End of file can be tested with the t test condition.
  1620.  
  1621.         SEE ALSO: putv command
  1622.  
  1623.       HAndshake {off|sw|on|cts|dsr|dcd|both|slow|ax} Some modems and
  1624.         printers cannot accept continuous full speed data.  These devices
  1625.         send control characters (XOFF and XON) for flow control, or generate
  1626.         a hardware flow control signal on the CTS, DSR, or DCD pin.  The
  1627.         Handshake command controls the modem port hardware handshake
  1628.         (default sw).[10]
  1629.  
  1630.         If hardware handshaking is selected, an ON to OFF transition on the
  1631.         specified control pin pauses transmission, and an XON character will
  1632.         not override the hardware restraint.
  1633.  
  1634.         After a timeout set by the S numeric parameter (default 60 seconds),
  1635.         or if characters are in the keyboard input buffer, a warning message
  1636.         is displayed, the restraint is released, and characters are sent.
  1637.  
  1638.         As a special case, handshake on obeys output flow control with the
  1639.         CTS input signal, asserts input flow control with the RTS output
  1640.  
  1641.  
  1642.       __________
  1643.  
  1644.       10. ZCOMM automatically disables its software (XON/XOFF) flow control
  1645.           when using XMODEM, YMODEM and similar protocols that require all
  1646.           256 byte codes.  These protocols may not work if the modem is set
  1647.           for software flow control.
  1648.  
  1649.  
  1650.  
  1651.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1652.  
  1653.  
  1654.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                  119
  1656.  
  1657.         signal, and disables the transmission of XOFF characters when the
  1658.         modem input buffer becomes nearly full.
  1659.  
  1660.         Some computers do not support concurrent disk and serial I/O at high
  1661.         speeds.  The handshake slow command drops the RTS signal to the
  1662.         modem during disk writes when receiving files with YMODEM-g or
  1663.         ZMODEM.  The handshake slow command does not correct overrun
  1664.         problems caused by TSRs and multitasking executives.
  1665.  
  1666.         The handshake both command allows either CTS or XOFF to pause
  1667.         output, in addition to asserting input flow control with the RTS
  1668.         output.  This is useful when the local modem uses CTS/RTS hardware
  1669.         flow control, but calls a timeshaing system or network such as
  1670.         GEnie, CompuServe, Telenet, or Tymnet that uses software (XON/XOFF)
  1671.         flow control.
  1672.  
  1673.         The handshake dcd command enables d term option (q.v.).
  1674.         Subsequently, selecting a different type of handshaking will disable
  1675.         d term option.  Use of handshake dcd is not recommended.
  1676.  
  1677.         The handshake off command disables all flow control except for XOFF
  1678.         characters sent by the term function.
  1679.  
  1680.         The handshake ax command takes the low order 5 bits of the first
  1681.         letter of the command (usually "a") and writes them to the
  1682.         8250/16550 UART Modem Control Register.  This hack is specific to
  1683.         PCDOS flavors.  A typical application is "ha ax" which raises Data
  1684.         Terminal Ready (bit 0) but turns off Request To Send, useful for
  1685.         interfacing to the Radio Shack Micronta Cat. No. 22-182 LCD Digital
  1686.         Multimeter with PC Interface.  This instrument uses an optical
  1687.         coupler and will not communicate unless DTR is ON and RTS is OFF.
  1688.  
  1689.         The handshake command (without argument) releases flow control
  1690.         (allows data to flow if it had been stopped by handshaking).
  1691.  
  1692.         Changing the communications port with the port or portx command
  1693.         disables hardware handshaking.
  1694.  
  1695.         Operation of the handshake command varies with the operating system
  1696.         and hardware used.
  1697.  
  1698.  
  1699.         SEE ALSO: S numeric parameter
  1700.  
  1701.         EXAMPLE: handshake cts Turns on CTS handshaking.
  1702.  
  1703.  
  1704.       help The help command uses the helpfile or xhelpfile string parameter
  1705.         depending on whether ZCOMM is in host operation.  Normally, the help
  1706.         command displays a command summary, pausing every 24 lines.
  1707.  
  1708.  
  1709.  
  1710.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1711.  
  1712.  
  1713.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                  120
  1715.  
  1716.         If the string parameter begins with the character @, ZCOMM uses the
  1717.         rest of the parameter as the initial command to access a pop-up help
  1718.         program.  The contents of the f string parameter are added to this
  1719.         command, separated by a space.  Thus, if helpfile contains "@yhp
  1720.         /umanh.hlp", giving the help command from the main prompt executes
  1721.         the DOS command "yhp /umanh.hlp main".
  1722.  
  1723.         If the called program leaves a file yamhelp.tmp containing script
  1724.         commands in the current directory, ZCOMM executes this file with a
  1725.         source command and then deletes it.
  1726.  
  1727.         SEE ALSO: f, helpfile, xhelpfile string parameters, source command
  1728.  
  1729.       history [histfile] Opens histfile for use as a dual 64 entry history
  1730.         file for commands entered both at the ZCOMM command prompt and
  1731.         online with the term function.  Histfile is a random access file
  1732.         used as a pair of circular buffers to save commands for recall.
  1733.         Only a file created by a previous history command may be used with
  1734.         the history command.  If the specified histfile does not exist, it
  1735.         is created.  Histfile stores commands with T or more characters
  1736.         where T is the value of the T (threshold) numeric parameter.
  1737.  
  1738.         If histfile is not specified with the history command, the current
  1739.         history file is updated and closed.
  1740.  
  1741.         The history command may be given with a different file name whenever
  1742.         desired to access useful commands saved from previous sessions with
  1743.         a particular host or application.
  1744.  
  1745.         When history is enabled, the Up and Down function keys scroll
  1746.         through previously entered commands.  Ctrl-P and Ctrl-N may be used
  1747.         in place of Up and Down respectively.  An old command so selected
  1748.         may be edited with editing keys described in Chapter 18 and executed
  1749.         with the <ENTER> key.
  1750.  
  1751.         In the term function, the history accessed with the Up and Down keys
  1752.         is displayed and edited in the status line. [11] A Ctrl-X clears the
  1753.         recalled text and restores normal status line and keyboard
  1754.         operation.
  1755.  
  1756.         EXAMPLE: history /tmp/favbbs.hist
  1757.  
  1758.  
  1759.         SEE ALSO: r command, T numeric parameter
  1760.  
  1761.  
  1762.       __________
  1763.  
  1764.       11. Unix/Xenix flavors only support Backspace editing in this term
  1765.           option.
  1766.  
  1767.  
  1768.  
  1769.       (C) 1993 Omen Tech Inc                        Chapter 19 Main Commands
  1770.  
  1771.